home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 038a / remfax.zip / MVRFAX.DOC < prev    next >
Text File  |  1993-02-15  |  12KB  |  317 lines
  1. What is MVRFAX?
  2. ---------------
  3. MVRFAX allows you to use your ZyXEL modem as a remote controlled fax
  4. machine. If you are travelling a lot and have to leave your office
  5. unattended for lengthy periods you probably are already using an
  6. answering machine to collect your voice mail. MVRFAX allows you to
  7. do this for fax mail as well. There are two ways for you to get to
  8. your fax mail: Either by logging on with a computer or by calling
  9. by phone.
  10.  
  11. If you log on from another computer you will get to a mailbox (BBS)
  12. system of your choice. This is NOT part of MVRFAX. The section 
  13. "Configuring MVRFAX" tells you how to integrate your BBS package.
  14. Retrieving your faxes this way is simply a matter of downloading them.
  15.  
  16. If you are using a phone you can have your faxes be sent to a fax machine
  17. near you. Of course you can change the number MVRFAX will send the faxes
  18. to from remote.
  19.  
  20.  
  21. What MVRFAX is NOT
  22. ------------------
  23. MVRFAX is NOT an answering machine. A decent answering machine with
  24. remote control can be bought for a fraction of a ZyXEL and usually
  25. delivers better voice quality.
  26.  
  27.  
  28. How it's implemented
  29. --------------------
  30. MVRFAX is based upon three ZyXEL utilities:
  31.    ZFAX .......... comes with your ZyXEL
  32.    RCVFAX ........ comes with your ZyXEL
  33.    ZUTIL ......... comes with MVRFAX
  34.  
  35. ZFAX and RCVFAX MUST be version 2.2 (or above?).
  36.  
  37. ZUTIL is a public domain utility from Kolja Waschk. It's his utility
  38. that allowed me to automate my office. Many thanks for such a fine
  39. program!
  40.  
  41. In addition to the above utilities you will need a Fossil driver to
  42. drive your comm port (ZUTIL needs that).
  43.  
  44. The rest of MVRFAX are just a few gigantic .BAT files.
  45.  
  46.  
  47. The Legal Department
  48. --------------------
  49. Users of MVRFAX must accept the following disclaimer of warranty:
  50.  
  51. THIS COPYRIGHTED SOFTWARE AND ITS DOCUMENTATION IS PROVIDED ON AN "AS IS"
  52. BASIS. THE AUTHOR MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED,
  53. INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY AND/OR
  54. FITNESS FOR A PARTICULAR PURPOSE.
  55.  
  56. THE USER ASSUMES ALL RISKS OF THE USE OF THIS SOFTWARE. THE AUTHOR 
  57. ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY
  58. RESULT FROM THE USE OR MISUSE OF MVRFAX.
  59.  
  60. As it cannot be guaranteed that loss of data will not occur, MVRFAX 
  61. should be tested with non-critical data. As always, judicious backups are
  62. a wise and necessary continuing precaution.
  63.  
  64. Now that the necessary legal issues are out of the way:
  65.  
  66. Kolja Waschk put his utility into public domain. So, in the best of all
  67. hacker spirits, this is my distribution policy:
  68.  
  69. MVRFAX is a program I wrote because I needed an easy way to collect my
  70. fax mail from remote.
  71.  
  72. MVRFAX is "zero-registration" shareware. That means, you may use it
  73. freely, without notifying me or anyone else, and without paying one cent.
  74. I sincerely hope it will satisfy you.
  75.  
  76. You may freely distribute MVRFAX, as long as the archive file remains
  77. unmodified. I expressly forbid to add any files, or any comments to the
  78. archive.
  79.  
  80.  
  81. Contacting the Author
  82. ---------------------
  83. If you have questions or ideas for future enhancements of MVRFAX, I'd be
  84. glad if you would contact me via CompuServe. Of course, I'll be happy if
  85. you just want to tell me the program works well.
  86.  
  87.    Michael Vesely 100023,3375
  88.  
  89. If you want to contact Kolja Waschk, look up his addresses in the file
  90. ZUTIL.MAN.
  91.  
  92.  
  93. Installing MVRFAX
  94. -----------------
  95.    o Put ALL MVRFAX files in ONE directory
  96.    o You need the ZyXEL utilities ZFAX and RCVFAX in ONE directory 
  97.      (which not necessarily must be the one where MVRFAX is)
  98.    o Create a directory OLD under the ZFAX/RCVFAX directory (this
  99.      will hold the information about which faxes have already been
  100.      delivered to you)
  101.    o Configure MVRFAX (see below "Configuring MVRFAX")
  102.  
  103. Here is the directory structure I use (the MVRFAX default settings relect
  104. this setup):
  105.  
  106.    C:\
  107.    │
  108.    └───ZYXEL
  109.        │
  110.        ├───ZFAX
  111.        │   │
  112.        │   └───OLD
  113.        │
  114.        └───MVRFAX
  115.  
  116. The Fossil driver I use (BNU) can be found via the PATH variable.
  117.  
  118.  
  119. System Requirements
  120. -------------------
  121.    o IBM or compatible and approx. 300 kB free memory
  122.    o a Fossil driver (BNU, X00,...); this is NOT included in MVRFAX
  123.    o ZyXEL modem (ROM version >= 5.00M, MegaBit-Eproms)
  124.    o ZFAX and RCVFAX version 2.2
  125.    o hard disk
  126.  
  127.  
  128. General information
  129. -------------------
  130. You run MVRFAX from the DOS command line:
  131.  
  132.    o change to the directory where MVRFAX resides
  133.    o start MVRFAX:
  134.  
  135.    MVRFAX can take two optional parameters:
  136.  
  137.    Parameter 1 = /L means use last callback number
  138.    Parameter 2 = /L means local call (no password needed)
  139.  
  140.    Both parameters must be written UPPERCASE.
  141.  
  142. MVRFAX remembers the last callback number in a file called TELPLAY.BAT.
  143. It is built while you enter a callback number from remote and used by
  144. MVRFAX to speak the number back to you. It's a good idea to have several
  145. pre-canned TELPLAY-style files for your most often used callback numbers.
  146. Let's say you have one such file for Acme Inc. called ACME.BAT:
  147.  
  148. Just before you leave the office start MVRFAX by:
  149.  
  150.    copy ACME.BAT TELPLAY.BAT
  151.    MVRFAX /L
  152.  
  153. This will set up the number of Acme's fax machine as the callback number.
  154. All you will then have to do from remote is:
  155.  
  156.    o call your office
  157.    o press "#" or "*" to present yourself to MVRFAX
  158.    o enter your password
  159.    o press "3" and confirm with either "#" or "*"
  160.  
  161. A few moments later all your new faxes will be delivered to the fax
  162. machine near you!
  163.  
  164. When in the office: To end MVRFAX press Ctrl-Break and Ctrl-C.
  165.  
  166. Although MVRFAX is rather flexible there are a few things hard-coded. Of
  167. course you could even change these (as you've got the source code):
  168.  
  169.    Confirmation is always done by pressing "#" or "*".
  170.  
  171.    The low tone (approx. 400 Hertz) is used for every prompt
  172.    except for the info "There are NO new faxes" and for the
  173.    initial tone when there are no new faxes. In these cases a
  174.    1200 Hertz tone is used.
  175.  
  176.    All messages are recorded using the CELP mode. This mode, while
  177.    not giving the best possible recording quality, allows for the
  178.    most reliable detection of DTMF codes.
  179.  
  180. You will hear a confirmation tone after each DTMF code that MVRFAX
  181. recognized. You have 20 seconds to enter a code. The best results have
  182. been achieved when you wait approx. 1-2 seconds after each prompt.
  183.  
  184.  
  185. Configuring MVRFAX
  186. ------------------
  187. All user definable settings are contained in the file MVRFAX.BAT. They
  188. are implemented as environment variables, so make sure your environment
  189. space is large enough. The settings are:
  190.  
  191.    MV_PORT ......... comm port (0=COM1, 1=COM2, ...)
  192.    MV_ZFXDRV ....... drive where ZFAX/RCVFAX are located
  193.    MV_ZFXDIR ....... directory where ZFAX/RCVFAX are located 
  194.                      and faxes are stored                            
  195.    MV_DRV .......... drive where MVRFAX is located
  196.    MV_DIR .......... directory where MVRFAX is located
  197.    MV_FSTART ....... command to load/start FOSSIL driver
  198.    MV_FSTOP ........ command to remove/stop FOSSIL driver
  199.    MV_DIALOUT ...... dial prefix (blanked by _MVRFAX.BAT for local calls)
  200.    MV_BEEPLEN ...... length of beep (in .1 secs)
  201.    MV_FAXRING ...... number of rings, if NO new fax available
  202.    MV_PWD .......... password
  203.    MV_PWRON ........ .BAT command to turn power on (after an incoming
  204.                      call has been detected)
  205.    MV_PWROFF ....... .BAT command to turn power off (while waiting for
  206.                      an incoming call)
  207.  
  208. The default values are:
  209.  
  210.    MV_PORT=1
  211.    MV_ZFXDRV=C:
  212.    MV_ZFXDIR=\ZYXEL\ZFAX
  213.    MV_DRV=C:
  214.    MV_DIR=\MVRFAX
  215.    MV_FSTART=BNU /T:16384 /R:16384 /L%PORT%:19200 /M-
  216.    MV_FSTOP=BNU /U
  217.    MV_DIALOUT=
  218.    MV_BEEPLEN=5
  219.    MV_FAXRING=1
  220.    MV_PWD=1 2 3
  221.    MV_PWRON=
  222.    MV_PWROFF=
  223.  
  224. There are two other settings you might want to check. One is the modem
  225. init string. It's found in line 18 in _MVRFAX.BAT:
  226.  
  227.    ZUTIL S /P%MV_PORT% /T3 "AT&FX7S41.4=1S7=90+VSD=5,100|" "OK"
  228.                                 ~~~~~~~~~
  229. If you are changing it, ONLY change the underlined part!!!
  230.  
  231. The other is the BBS software that will be loaded if you are logging
  232. in from remote. It's found in line 98 in _MVRFAX.BAT:
  233.  
  234.    echo TELIX O SHOSTPLUS
  235.  
  236. Although you can call almost any communications program at this point, 
  237. this program MUST NOT initialize the comm-port and modem as they are 
  238. already initialized and CONNECTED TO YOU. 
  239.  
  240.  
  241. Using MVRFAX from a Phone
  242. -------------------------
  243. Call your ZyXEL. The number of rings you have to wait depends upon your
  244. configuration. To change it, read below "Configuring MVRFAX". If you are
  245. just checking for new faxes and set up a distinct number of rings if 
  246. there are no new faxes, you already know what you want to know.
  247.  
  248. You will hear a short tone, either high or low. A high tone means "NO
  249. new faxes" whereas a low tone means "There are new faxes". If you just
  250. wanted to check for faxes you can hangup now.
  251.  
  252. Press "#" or "*". A low tone confirms and if you have configured a
  253. password you will be asked to enter it. Enter each number and wait for
  254. the confirmation tone. If you do not hear the tone, just re-enter the
  255. number as you've probably been too fast. You have 20 seconds for each 
  256. number.
  257.  
  258. You will be asked to enter a 1-digit command. Enter one of the numbers
  259. below:
  260.  
  261.       Enter    To
  262.        0       check for faxes
  263.        1       get callback number
  264.        2       set callback number
  265.        3       call back (deliver faxes)
  266.        4       delete old faxes
  267.        5       call external program EXTERN.BAT
  268.  
  269. Again, you've got 20 seconds. If you do not hear the confirmation tone,
  270. just re-enter the number.
  271.  
  272. Now follows a short description of each command:
  273.  
  274. Command 0 - Check for faxes
  275. If there are new faxes you will hear a low tone and "There are new 
  276. faxes". If there are no faxes you will hear a high tone and "There are no
  277. new faxes".
  278. Afterwards you will be prompted for a new command to be entered.
  279.  
  280. Command 1 - Get callback number
  281. If there is a callback number, you will hear each digit spoken. If there
  282. is no callback number, you will hear "No callback number defined".
  283. Afterwards you will be prompted for a new command to be entered.
  284.  
  285. Command 2 - Set callback number
  286. You will be asked to enter the callback number. Again, you've got 20 
  287. seconds for each number. If you do not hear the confirmation tone, just
  288. re-enter the number. When you are done either wait (for up to 10 seconds)
  289. or press "#" or "*". You will then hear the callback number (each digit
  290. will be spoken) and will be asked for confirmation. Press "*" or "#" to
  291. confirm. 
  292. Afterwards you will be prompted for a new command to be entered.
  293.  
  294. Command 3 - Call back
  295. If there are no new faxes or the callback number is missing you will be
  296. informed. Otherwise you will be prompted to confirm that you want your 
  297. faxes to be sent to the callback number. Again, press "#" or "*". After
  298. successful confirmation you will hear a "Thank you" message and MVRFAX
  299. goes on-hook. Go to the fax machine and wait for your faxes.
  300.  
  301. Command 4 - Delete old faxes
  302. Old faxes tend to fill up quite some space on your hard disk. You can
  303. delete them from remote with this command. You will be asked to confirm.
  304. Press "#" or "*". After successful removal you will be informed ("Old
  305. faxes have been deleted").
  306. Afterwards you will be prompted for a new command to be entered.
  307.  
  308. Command 5 - Call external program
  309. This command will execute a batch file called EXTERN.BAT. Use this file
  310. to remote execute any command you need.
  311. Afterwards you will be prompted for a new command to be entered.
  312.  
  313.  
  314.  
  315.  
  316.  
  317.